The CDFlist program allows you to selectively list all (or a subset of) the
variable data values from a CDF.  The values can be displayed at the
screen, output to a text file, or used to create a new CDF (the new CDF may
be a subset of the original CDF).

The user interface to CDFlist is contained on a single screen which is
divided into several fixed windows and pop-up windows.  The Action Menu
controls the execution of the program.  This menu allows you to move to a
different window, start the data output, browse a help file, or exit the
program.  You must return to this menu each time you want to select a new
variable, output option, listing type, or input CDF.  This menu may be
displayed at any time by entering Ctrl-F.  Use the up and down arrow keys
to highlight a choice in the Action Menu and then enter a carriage return
to execute that function.  Two very important windows are the Keypad
Definition and Message windows.  They contain information on keypad
functionality and program status/error messages.

When CDFlist is executed (and a CDF and/or directory is not entered on the
command line), you must first specify the CDF you wish to list.  If you
enter a full disk/directory specification (without a CDF name), all of the
CDFs in the specified directory will appear in a separate pop-up window.
Use the up and down arrow keys to choose a CDF, and then enter a carriage
return to list that CDF.

The Output window will then be displayed with the valid choices.  Use the
up and down arrow keys to scroll up and down within the menu and then enter
a carriage return to select the desired output option.  If output to an
ASCII file or CDF is selected, you will be prompted for a file/CDF name.
You may enter any file/CDF name valid for the operating system being used
or accept the default file/CDF name that appears.  Do not enter a file
extension (it is automatically appended).  The file extension for a
generated text file is .dat.

The second window that remains constant on the screen is the Variable
Selection window.  This window allows the user to select the variables that
are to be listed or put into a CDF along with any desired filters on the
variables.  You will automatically be placed in this window after you have
entered an output option.  You can also enter this window by entering
Ctrl-F to bring up the Action Menu and then select the Select Variables
menu option.

There are three fields on each line in the Variable Selection window:
variable name, minimum filter value, and maximum filter value.  You can
move forward to the next field by entering a carriage return or backwards
to the previous field with a Ctrl-H.  You may also use the up and down
arrow keys to move vertically through the fields.  When the cursor is
positioned in a variable name field, entering Ctrl-P will display the
variables in the CDF in a pop-up window.  Use the arrow keys to highlight a
variable and then enter a carriage return to select it.  You can quit the
pop-up window without selecting a variable by entering q (quit).  You may
also use the u and d keys to page up and down in the pop-up window.  The
first line in this pop-up menu contains **SELECT ALL**. Selecting this item
causes all of the variables in the CDF to be selected.

After selecting a variable, the cursor is positioned in the minimum filter
field.  A filter is simply the range of data that you would like to see
from the selected variable.  If just specifying a minimum filter value is
sufficient, a maximum filter value need not be entered.  You do not have to
enter a filter for each selected variable.  For a line of output (or a set
of CDF variable values) to be written for a given record/indices, each
filter must be passed.  There are two ways to enter minimum and maximum
filters.  The first is by simply entering the desired values in the
appropriate fields.  The second method can only be used for variables that
consist of a discrete set of values.  This method involves entering a
Ctrl-P (when in the desired filter field) which displays a pop-up window
that contains the discrete values for the variable.  The desired filter
value may then be selected.

When all of the desired variables and filters have been selected, enter
Ctrl-F to display the Action Menu.  Selecting "Generate Output" will cause
the listing or new CDF to be generated.  When CDFlist completes the
generation of the output, the Action Menu is redisplayed. It may then be
used to select a new CDF to list, respecify the output option, select new
variables/filters, get online help, or exit the program.

NOTE:

If you are running CDFlist under UNIX, your terminal output will be limited
to 132 characters per line.  If too many variables have been selected, the
output to a terminal screen will be truncated. Output to a file or CDF,
however, will not be affected (as many variables as desired may be
selected).
